Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_PT_UPDATELEVEL

EOS_PT_UPDATELEVEL

This function updates the specified fields and records of a single level.

Syntax

Result = EOS_PT_UPDATELEVEL(pointID, level, field, list, nrec, recs, data)

Return Value

Returns SUCCEED (0) if successful and FAIL (–1) otherwise.

Arguments

pointID

Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.

level

Level to update (0-based long).

fieldlist

List of fields (string) to update.

nrec

Number of records (long) to update.

recs

Record number of records to update (0-based long).

data

Values to be written to the fields. Data values are not converted to the internal HDF type automatically. Use HDF_PACKDATA if conversion is necessary or the data fields specify multiple types.

Keywords

None

Examples

In this example, we update records 0, 2, and 3 in the Temperature and Mode fields in the second level in the point referred to by the point ID pointID. Temperature is a 4 value 32-bit float field and Mode is a 4 character field (HDF types 5 and 4 respectively):

recs = [ 0, 2, 3]

dataTemperature = [ [20, 21, 22, 23], [30, 31, 32, 33], $

   [40, 41, 42, 43]]]

dataMode = ['P', 'I', 'A']

buffer = HDF_PACKDATA(dataTemperature, dataMode, $

   HDF_TYPE = [5, 4], HDF_ORDER = [4, 4])

status = EOS_PT_UPDATELEVEL( pointID, 1, "Temperature,Mode", $

   3, recs, buffer)

Version History

 

5.2

Introduced